home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / graphic / viewers / general / msdos / hv12 / hiview.doc < prev    next >
Encoding:
Text File  |  1992-07-22  |  9.4 KB  |  222 lines
  1.  
  2.  
  3.  
  4.  
  5.                                Hiview 1.2
  6.                        A JPEG/GIF/TGA File Viewer
  7.                          By Mohammad A. REZAEI
  8.                       rezaei@upenn5.hep.upenn.edu
  9.                          
  10.  
  11. INTRODUCTION
  12.         Hiview is a freeware JPEG/GIF/TGA file viewer for video cards
  13. with the TSENG 4000, ATI, TRIDENT 8900, AHEADA/B, Chips&Tech, Everex, Genoa, 
  14. Oak, Paradise,Tseng 3000, and Video 7 chipsets. The Hicolor mode on
  15. TSENG cards is supported. The viewer centers the image and scales it down
  16. to fit the screen, if necessary.
  17.  
  18. Please note that only the following modes will be used (only these 
  19. have square pixels!):
  20.  
  21.         640x480x256
  22.         800x600x256
  23.         1024x768x256
  24.         640x480x32k (Tseng 4000 only)
  25.         800x600x32k (Tseng 4000 only)
  26.         
  27. The hicolor modes are much faster and you can see something happening
  28. all the time. The 256 color modes must go through a quantization step
  29. where the screen is blanked and nothing is displayed.
  30.  
  31. REQUIREMENTS
  32.         o 386 computer.
  33.         o A video card with one the chipsets mentioned above.
  34.         o VCPI environemnt 
  35.                 (i.e., the code won't work under MS Windows or OS/2)
  36.  
  37. If you would like to compile the code yourself, you will additionally require:
  38.         o djgpp (actually no C++ extensions necessary)
  39.         o Source code from version 3 of the Independent JPEG group
  40.         o The LIBGRX extensions to djgpp.
  41. The JPEG source is available in many archives (wuacrvhie.wustl.edu,
  42. simtel, etc.). djgpp and LIBGRX are available from barnacle.erc.clarkson.edu.
  43.  
  44.  
  45. SETUP FOR THE VIEWER
  46.         As the code is compiled with djgcc, you need to set two environment
  47. variables: GO32 and GO32TMP. GO32 lets go32 (the dj extender) know what 
  48. graphics driver to use, and GO32TMP is the place you would like the
  49. temporary files to go (go32 swap directory). PLEASE NOTE: all directory
  50. slashes must be forward slashes (ala UNIX) not back slashes.
  51. For example, my settings are:
  52.  
  53. SET GO32TMP=c:/tmp
  54. SET GO32=ansi driver c:/djgcc/contrib/libgrx/drivers/et4000.grn
  55.  
  56. If you don't setup these variables properly, the code will crash and burn!
  57. In addition, if you don't have a 387, you need to add
  58.  
  59. emu <emu387 location>
  60. to the GO32 environment variable,
  61. where <emu387 location> is where you put the emu387 file.
  62.  
  63. For example, if you unpacked everything in c:\graphics, and you have
  64. a paradise video card with no 387, you would do:
  65.  
  66. SET GO32=ansi driver c:/graphics/paradise.grd emu c:/graphics/emu387
  67.  
  68. Please do not add any extra spaces to the above.
  69.  
  70.  
  71. After this setup, you can run hiview. It will look in the current directory
  72. for files matching *.jpg, *.gif and *.tga.
  73.  
  74. TROUBLESHOOTING
  75. There have also been reports about some incompatibilities with himem/emm386.
  76. Try removing these from your config.sys and rerun hiview, if you experience
  77. any segmetation faults. I recommend using QEMM or 386MAX as a memory manager.
  78.  
  79. Make sure you have setup the environment variables properly. Use "/" in
  80. the directory names, not "\".
  81.  
  82.  
  83. COMMAND LINE OPTIONS
  84.         With no command line options, hiview will look in the current directory
  85. for files matching *.jpg, *.gif and *.tga.
  86. You can include file specifications on the command line. The viewer expects
  87. that the file extension specify the file type, but you can override this with
  88. the -j, -g and -t flags for JPEG, GIF and TARGA respectively.
  89. So, if for some reason you have a file called "pic.jpg" which is actually
  90. a GIF file, you can view it with "hiview -g pic.jpg".
  91. Please note that any file specification appearing after these flags will
  92. be expected to be of that type, so "hiview -g pic1.gif pic2.tga" will think
  93. pic2.tga is a GIF file. To get the correct result, you can use
  94. "hiview pic2.tga -g pic1.gif" or "hiview -g pic1.gif -t pic2.tga".
  95.  
  96. The following flags toggle the desired effect:
  97.  
  98. -h Hicolor mode, default is on.
  99. -b Block smoothing, default is off.
  100. -p Pixel smoothing, default is off.
  101. -s <gamma> Gamma specification, default is 1.0, values between 0.1 and 2.0
  102.         are usually used.
  103. -i Linear interpolation, default is on. (24->15 bit only)
  104.         This helps alot if the scaling ratio (image/screen) is between
  105.         1 and 2. It doesn't help much if scaling ratio is above 2
  106. -d Floyd-Steinberg dithering, default is off for 15 bit and on for 8 bit
  107.         displays modes. Helps significantly with some images with smooth
  108.         shaded regions.
  109. -w Start slide show of available files. Waits for key press between 
  110.         images.
  111. -W <time in seconds> Start slide show of images, and wait specified time
  112.         between images.        
  113. -q 24->8 bit quatization, one pass or two pass, default is one pass.
  114. -T Measure how long it took to display the image.
  115.  
  116. All the above can be changed interactively from the menus.
  117.  
  118. USING HIVIEW INTERACTIVELY
  119.         Once the filenames are displayed, you can use the arrow keys
  120. to choose the file to be displayed. Pressing "O" gets you to the options
  121. menu.
  122.         You can also select several images to be shown one after another.
  123. Pressing SPACE select/deselect images. Images are displayed in order listed
  124. (not selected). After selecting the images, press RETURN to start the slide
  125. show. Unless you have specified otherwise (through the command line or
  126. options menu) the program will wait for a keypress between images.        
  127.        
  128. COPYRIGHTS AND SUCH
  129.         The source code for the viewer is included with the distribution.
  130. I have written most of the code in viewer.c, which is based on example.c of
  131. the JPEG distribution. This code is distributed with the same intentions and
  132. policies as the Independent JPEG group software. However, please note the
  133. copyrights and distribution policies of the portion of the code that is
  134. from any other source. This includes the djgpp stuff (the prepended
  135. go32 to hiview.exe, the 387 emulator), the LIBGRX drivers and the JPEG
  136. files distributed with the code. So please read COPYING and COPYING.DJ,
  137. COPYING.GRX and README.IJG.
  138.  
  139. DESIGN INTENTIONS
  140.         The code is intended to be as fast as possible with a user
  141. friendly interface and lots of options. Admitedly, the code is rather
  142. ugly in this initial release.        
  143.  
  144.         I strongly encourage additions and modifications to my code.
  145. However, to keep the distribution uniform, I would like to be the sole
  146. distributor of the viewer "hiview". So please send me your suggestions, and
  147. modifications. I can be reached as rezaei@upenn5.hep.upenn.edu until
  148. August 15, 1992. (I will have a different address after that.) If you intend
  149. to do any modifications, please read todo.doc.
  150.  
  151. BUGS AND LIMITATIONS
  152.         The viewer can't deal with a directory as a command line parameter.
  153. It can however deal with wildcards, so "hiview \pics" won't work, whereas
  154. "hiview \pics\*.jpg" will. Same is true for drive names: "hiview a:" is
  155. not supported, but "hiview a:*.*" is.
  156.  
  157.         The viewer cannot handle files larger than 4096x4096, but this
  158. can be easily changed by recompiling.
  159.         
  160.         You cannot display TARGA files in 8 bit mode (yet). Trying this
  161. will result in strange behaviour.
  162.  
  163.         Colormaped TARGA files are not supported.
  164.         
  165.         The ATI and TRIDENT modes are untested.
  166.  
  167.         Please see the todo.doc file for planned solutions to the above and
  168. improvements to be incorporated into the next release of the program.        
  169.         
  170.         -T option does not work well in slide show mode.
  171.  
  172. HISTORY
  173.  
  174. 7/6/92 version 1.0, initial release. Special thanks go to Bruce (bs@mda.ca)
  175. 7/7/92 version 1.1, now two executables, hiview.exe and jview.exe exist
  176.         hiview handles Tseng 4000, Ati and Trident 8900 chipsets.
  177.         jview handles the rest. Eventually, only hiview should exist.
  178.         On setups with no 387, there should be a significant speedup.        
  179.         modified files: makefile.*
  180.                         viewer.h
  181.                         viewer.c
  182.                         hiview.exe
  183.                         hiview.doc
  184.                         todo.doc
  185.         new files:      jview.exe
  186.                         *.grd (old graphics drivers)
  187.                         src/mkjview.lst
  188. 7/22/92 version 1.2. jview.exe no longer exists. hiview can use all cards.
  189.         this version is 10-20% faster than 1.1. It also eliminates the
  190.         initialization delays on machines with no 387. There is a primitive
  191.         slide show mode, and you can view pictures from the command line
  192.         (-w and -W switches). There is a 486-optimized executable: hiview4.exe
  193.         which is about 5% faster than it's 386 cousin on a 486. It will 
  194.         actually run on a 386, but slower. Dithering is now a global option
  195.         (and faster). -T option will show how long it took for an image
  196.         to display.
  197.         modified files:
  198.                 makefile
  199.                 makefile.opt
  200.                 mkhiview.lst
  201.                 viewer.c
  202.                 viewer.h
  203.                 dither.c
  204.                 hiview.exe
  205.                 hiview.doc
  206.                 readme.txt
  207.                 todo.doc
  208.         new files:
  209.                 range.c
  210.                 jquant1.c
  211.                 jquant2.c
  212.                 makefile.486
  213.                 hiview4.exe
  214.                 jdcolor.c
  215.                 jdmcu.c
  216.                 rangecalc.c
  217.                 mypow.c
  218.                 mypow.h
  219.                 logcalc.c
  220.                 jversion.h
  221.                 jconfig.h
  222.